# 📖 SCSBasic - Simple Control System - Sistema de Controle Veicular - By DOGGTA
## Manual Completo em Português Brasileiro

---

## 📋 ÍNDICE
1. [Sobre o Mod](#sobre-o-mod)
2. [Requisitos](#requisitos)
3. [Instalação](#instalação)
4. [Configuração Recomendada do GTA V](#configuração-recomendada-do-gta-v)
5. [Controles Padrão](#controles-padrão)
6. [Personalização](#personalização)
7. [Exemplos de Configuração](#exemplos-de-configuração)
8. [Solução de Problemas](#solução-de-problemas)
9. [Perguntas Frequentes](#perguntas-frequentes)

---

## 🎯 SOBRE O MOD

O **SCSBasic** é um mod manual de controle veicular para GTA V que adiciona controles realistas de faróis, setas, pisca-alerta, motor e vidros. 

### Características Principais:
- ✅ **Sistema de setas nativo do GTA V** - Pisca-pisca perfeitamente sincronizado
- ✅ **Controle completo de iluminação** - Faróis, farol alto e pisca-alerta
- ✅ **Controle de motor** - Liga/desliga com som de partida
- ✅ **Controle de vidros** - Sobe/desce vidros dianteiros
- ✅ **Totalmente configurável** - Personalize todas as teclas via arquivo .ini
- ✅ **Menu informativo** - Visualize status e controles no jogo

---

## 💾 REQUISITOS

### Obrigatórios:
1. **Grand Theft Auto V** (versão atualizada)
2. **ScriptHookV** - [Download aqui](http://www.dev-c.com/gtav/scripthookv/)
3. **ScriptHookVDotNet3** - [Download aqui](https://github.com/scripthookvdotnet/scripthookvdotnet-nightly/releases)

### Estrutura de Pastas:
```
Grand Theft Auto V/
├── ScriptHookV.dll
├── dinput8.dll
└── scripts/
    ├── ScriptHookVDotNet3.dll
    ├── SCSBasic.dll          ← Este mod
    └── SCSBasic.ini          ← Arquivo de configuração
```

---

## 🔧 INSTALAÇÃO

### Passo 1: Preparar o GTA V
1. Certifique-se que **ScriptHookV** e **ScriptHookVDotNet3** estão instalados
2. Verifique se a pasta `scripts` existe em `Grand Theft Auto V/`
3. Se não existir, crie a pasta `scripts`

### Passo 2: Instalar o SCSBasic
1. Coloque **SCSBasic.dll** na pasta `scripts/`
2. Coloque **SCSBasic.ini** na pasta `scripts/` (mesmo local da DLL)

### Passo 3: Verificar Instalação
1. Inicie o GTA V
2. Você deve ver a mensagem: **"SCSBasic loaded!"**
3. Se aparecer **"Config file not found"**, verifique se o .ini está no lugar correto

---

## ⚙️ CONFIGURAÇÃO RECOMENDADA DO GTA V

### 🎮 IMPORTANTE: Reatribuir Teclas do Jogo

Por padrão, o GTA V usa **Q** e **E** para Radio e buzina em veículos.
Como o SCSBasic usa essas teclas para as setas, **é altamente recomendado reatribuir essas funções do jogo**.

### Como Reatribuir:

1. **Abra o menu de configurações do GTA V**
2. **Vá em: Configurações → Controles**
3. **Encontre e altere:**

   **Tecla E:**
   - **Recomendação:** Reatribuir para **BOTÃO DO MEIO DO MOUSE** (scroll click)
   - Alternativa: Qualquer tecla de sua preferência (F, G, etc.)

   **Tecla Q (Seletor de estação de radio):**
   - **Recomendação:** Reatribuir para qualquer tecla de sua preferência
   - Sugestões: ´, ou qualquer tecla que você não use frequentemente

### Por que fazer isso?

✅ **Evita conflitos** - Sem teclas duplicadas  
✅ **Mais intuitivo** - Q = seta esquerda, E = seta direita (como teclado de seta)  
✅ **Botão do mouse é prático** e a sensação de apertar a buzina é muito mais real. 
✅ **Imersão** - Controles veiculares realistas sem interferência

---

## CONTROLES PADRÃO

### Iluminação:
- **H** (pressionar) → Liga/desliga faróis
- **H** (segurar 2s) → Liga/desliga pisca-alerta
- **SHIFT + H** → Liga/desliga farol alto

### Setas:
- **Q** → Seta ESQUERDA ◄
- **E** → Seta DIREITA ►

### Motor e Vidros:
- **SHIFT + T** → Liga/desliga motor
- **SHIFT + Y** → Sobe/desce vidros dianteiros

### Menu:
- **SHIFT + I** → Abre/fecha menu de informações

---

## 🛠️ PERSONALIZAÇÃO

### Arquivo de Configuração: `SCSBasic.ini`

Todas as teclas podem ser personalizadas editando o arquivo `SCSBasic.ini` localizado em `Grand Theft Auto V\scripts\`

### Estrutura do Arquivo:

```ini
[Controls]

; Faróis e Luzes
KeyHeadlights=H
KeyHazardLights=H
KeyHighBeams=H
UseShiftForHighBeams=true

; Setas
KeyLeftSignal=Q
KeyRightSignal=E

; Motor
KeyToggleEngine=T
UseShiftForEngine=true

; Vidros
KeyToggleWindows=Y
UseShiftForWindows=true

; Menu
KeyShowMenu=I
UseShiftForMenu=true
```

### Teclas Disponíveis:

#### Letras:
```
A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z
```

#### Números (use D antes do número):
```
D0, D1, D2, D3, D4, D5, D6, D7, D8, D9
```

#### Teclas de Função:
```
F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12
```

#### NumPad:
```
NumPad0, NumPad1, NumPad2, NumPad3, NumPad4, NumPad5, 
NumPad6, NumPad7, NumPad8, NumPad9
```

#### Setas:
```
Left, Right, Up, Down
```

#### Especiais:
```
Space, Enter, Tab, Back, Delete, Insert, Home, End, PageUp, PageDown
```

---

## 📝 EXEMPLOS DE CONFIGURAÇÃO

### Exemplo 1: Usar NumPad para Setas
```ini
KeyLeftSignal=NumPad4
KeyRightSignal=NumPad6
```

### Exemplo 2: Usar Setas do Teclado
```ini
KeyLeftSignal=Left
KeyRightSignal=Right
```

### Exemplo 3: Remover SHIFT de Tudo
```ini
UseShiftForHighBeams=false
UseShiftForEngine=false
UseShiftForWindows=false
UseShiftForMenu=false
```

### Exemplo 4: Menu com F1 (sem SHIFT)
```ini
KeyShowMenu=F1
UseShiftForMenu=false
```

### Exemplo 5: Controles Separados de Faróis
```ini
KeyHeadlights=H
KeyHazardLights=J
KeyHighBeams=L
UseShiftForHighBeams=false
```

### Exemplo 6: Motor com G (sem SHIFT)
```ini
KeyToggleEngine=G
UseShiftForEngine=false
```

---

## 🔍 SOLUÇÃO DE PROBLEMAS

### Problema: "Config file not found"

**Causa:** O arquivo SCSBasic.ini não está no lugar correto

**Solução:**
1. Verifique se `SCSBasic.ini` está em `Grand Theft Auto V\scripts\`
2. Certifique-se que está no **mesmo local** que `SCSBasic.dll`
3. Verifique se o arquivo não é `SCSBasic.ini.txt` (Windows pode ocultar extensões)

**Como verificar extensões de arquivo:**
1. Abra o Explorer
2. Clique em "Exibir"
3. Marque "Extensões de nomes de arquivos"

---

### Problema: Mod não carrega

**Verificações:**
1. ✅ ScriptHookV instalado?
2. ✅ ScriptHookVDotNet3 instalado?
3. ✅ Arquivos na pasta `scripts/`?
4. ✅ Jogo atualizado?

**Como diagnosticar:**
1. Abra `ScriptHookV.log` na pasta do GTA V
2. Procure por erros relacionados a "SCSBasic"
3. Verifique se há mensagens de erro

---

### Problema: Teclas não funcionam

**Possíveis causas:**

1. **Conflito com GTA V:**
   - Reatribua as teclas Q e E no jogo (veja [Configuração Recomendada](#configuração-recomendada-do-gta-v))

2. **Erro no .ini:**
   - Verifique se não há espaços extras: `KeyLeftSignal=Q` (correto)
   - Não use: `KeyLeftSignal = Q` (errado - espaços)

3. **Nome da tecla incorreto:**
   - Use `NumPad5` não `numpad5` (case-sensitive)
   - Use `D0` para o número 0, não apenas `0`

**Solução:**
1. Teste com configuração padrão primeiro
2. Altere uma tecla por vez
3. Recarregue o script (Insert → Reload All Scripts)

---

### Problema: Setas invertidas

**Solução:**
Edite `SCSBasic.ini` e troque:
```ini
KeyLeftSignal=E
KeyRightSignal=Q
```

---

### Problema: Pisca-pisca irregular

**Solução:**
O mod usa o sistema NATIVO do GTA V para pisca-pisca. Se estiver irregular:

1. Teste em diferentes veículos
2. Verifique FPS do jogo (baixo FPS pode afetar)
3. Atualize o GTA V para versão mais recente

---

## ❓ PERGUNTAS FREQUENTES

### Q: Posso usar com outros mods?
**A:** Sim! SCSBasic é compatível com a maioria dos mods. Apenas certifique-se que não há conflitos de teclas.

### Q: Funciona online?
**A:** **NÃO!** ScriptHookV e mods em geral **NÃO funcionam no GTA Online** e podem resultar em ban. Use apenas em **Story Mode**.

### Q: Como recarregar o script sem reiniciar?
**A:** Pressione **Insert** no jogo e selecione **"Reload All Scripts"**

### Q: Posso mudar a velocidade do pisca-pisca?
**A:** Não. O mod usa o sistema nativo do GTA V que já possui timing perfeito e realista.

### Q: O mod salva o estado das luzes?
**A:** Não. Ao trocar de veículo ou reiniciar o jogo, todas as luzes voltam ao estado padrão (desligadas).

### Q: Por que usar Q e E para setas?
**A:** É intuitivo (Q = esquerda, E = direita) e ergonômico. Por isso recomendamos reatribuir as funções padrão do GTA V.

### Q: Posso usar com volante/controle?
**A:** O mod funciona apenas com teclado. Para volante/controle, você precisaria de software adicional para mapear botões para teclas.

### Q: Como desinstalar?
**A:** 
1. Delete `SCSBasic.dll` da pasta `scripts/`
2. Delete `SCSBasic.ini` da pasta `scripts/`
3. (Opcional) Restaure as teclas Q e E do GTA V

---

## 📞 SUPORTE

### Arquivos de Log:
- `ScriptHookV.log` - Log principal do ScriptHookV
- Localizado na pasta raiz do GTA V

### Informações Úteis para Reportar Problemas:
1. Versão do GTA V
2. Versão do ScriptHookV
3. Versão do ScriptHookVDotNet
4. Conteúdo do arquivo `SCSBasic.ini`
5. Mensagens de erro (se houver)

---

## 📄 LICENÇA E CRÉDITOS BY DOGGTA

**Desenvolvido para GTA V**  
Requer ScriptHookV e ScriptHookVDotNet3

**Nota:** Este mod é fornecido "como está". Use por sua conta e risco.  
Sempre faça backup dos arquivos do jogo antes de instalar mods.

---

## 🎉 APROVEITE!

Agora você tem controle total e realista do seu veículo no GTA V!

**Bom jogo!** 🚗💨
